ArcPad Preferences File Schema
LISTBOX Element
See Also Send comments on this topic.

ArcPad Preferences File Schema > PAGE Element : LISTBOX Element

Glossary Item Box

Description

Used to define a ListBox control in a form.

Diagram

Overview

LISTBOX

Used to define a ListBox control in a form.

height required Restriction of xs:int

width required Restriction of xs:int

x required xs:int

The x coordinate of the upper left corner of the list box.

y required xs:int

The y coordinate of the upper left corner of the list box

backgroundcolor optional xs:string

border optional Restriction of xs:string

color optional xs:string

defaultvalue optional xs:string

field optional xs:string

font optional xs:string

fontsize optional Restriction of xs:int

fontstyle optional Restriction of xs:string

group optional Restriction of xs:string

hscroll optional Restriction of xs:string

listtable optional xs:string

listtextfield optional xs:string

listvaluefield optional xs:string

name optional xs:string

onkillfocus optional xs:string

Specify the script to run when this event occurs.

onselcancel optional xs:string

Specify the script to run when this event occurs.

onselchange optional xs:string

Specify the script to run when this event occurs.

onsetfocus optional xs:string

Specify the script to run when this event occurs.

onvalidate optional xs:string

Specify the script to run when this event occurs.

readonly optional Restriction of xs:string

required optional Restriction of xs:string

showvalues optional Restriction of xs:string

sort optional Restriction of xs:string

tabstop optional Restriction of xs:string

vscroll optional Restriction of xs:string

Sequence

LISTITEM 1..∞

Used to define an item in a ComboBox or ListBox form control.

Attributes

Name	Type	Use	Default	Fixed	Description
height	Restriction of xs:int	required
width	Restriction of xs:int	required
x	xs:int	required			The x coordinate of the upper left corner of the list box.
y	xs:int	required			The y coordinate of the upper left corner of the list box
backgroundcolor	xs:string	optional
border	Restriction of xs:string	optional	false
color	xs:string	optional
defaultvalue	xs:string	optional
field	xs:string	optional
font	xs:string	optional
fontsize	Restriction of xs:int	optional
fontstyle	Restriction of xs:string	optional	regular
group	Restriction of xs:string	optional	false
hscroll	Restriction of xs:string	optional	false
listtable	xs:string	optional
listtextfield	xs:string	optional
listvaluefield	xs:string	optional
name	xs:string	optional
onkillfocus	xs:string	optional			Specify the script to run when this event occurs.
onselcancel	xs:string	optional			Specify the script to run when this event occurs.
onselchange	xs:string	optional			Specify the script to run when this event occurs.
onsetfocus	xs:string	optional			Specify the script to run when this event occurs.
onvalidate	xs:string	optional			Specify the script to run when this event occurs.
readonly	Restriction of xs:string	optional	false
required	Restriction of xs:string	optional	false
showvalues	Restriction of xs:string	optional
sort	Restriction of xs:string	optional	true
tabstop	Restriction of xs:string	optional	true
vscroll	Restriction of xs:string	optional	false

Examples

ArcPad layer file (*.apl) with an edit form.

Restrictions

The following attributes can only be used in edit and identify forms. They cannot be used in general forms:; field; required

Source

<xs:element name="LISTBOX" maxOccurs="1" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>Used to define a ListBox control in a form.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="LISTITEM" maxOccurs="unbounded">
        <xs:annotation>
          <xs:documentation>Used to define an item in a ComboBox or ListBox form control.</xs:documentation>
        </xs:annotation>
      </xs:element>
    </xs:sequence>
    <xs:attribute use="required" ref="height">
      <xs:annotation>
        <xs:documentation>The height of the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" ref="width">
      <xs:annotation>
        <xs:documentation>The width of the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="x" type="xs:int">
      <xs:annotation>
        <xs:documentation>The x coordinate of the upper left corner of the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="y" type="xs:int">
      <xs:annotation>
        <xs:documentation>The y coordinate of the upper left corner of the list box</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="backgroundcolor">
      <xs:annotation>
        <xs:documentation>The background color to use for the list box. If not specified, this value is inherited from the page's backgroundcolor attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="border">
      <xs:annotation>
        <xs:documentation>Specifies whether the list box has a border.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="color">
      <xs:annotation>
        <xs:documentation>The color to use for the list box's text. If not specified, this value is inherited from the page's color attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="defaultvalue">
      <xs:annotation>
        <xs:documentation>A simple expression that specifies the default value of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="field">
      <xs:annotation>
        <xs:documentation>The field of the shapefile's DBF table that is linked to the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="font">
      <xs:annotation>
        <xs:documentation>The font to use for the list box's text. If not specified, this value is inherited from the page's font attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="fontsize">
      <xs:annotation>
        <xs:documentation>The font size to use for the list box's text. If not specified, this value is inherited from the page's fontsize attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="regular" ref="fontstyle">
      <xs:annotation>
        <xs:documentation>The font style to use for the list box's text. If not specified, this value is inherited from the page's fontstyle attribute. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline").</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="group" default="false">
      <xs:annotation>
        <xs:documentation>Specifies whether the list box starts a new group of controls.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="hscroll">
      <xs:annotation>
        <xs:documentation>Specifies if the list box should have a horizontal scroll bar</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="listtable">
      <xs:annotation>
        <xs:documentation>The DBF table used to populate the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="listtextfield">
      <xs:annotation>
        <xs:documentation>The field of the DBF table that contains the data used to populate the text component of the list box's items.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="listvaluefield">
      <xs:annotation>
        <xs:documentation>The field of the DBF table that contains the data used to populate the value component of the list box's items.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="name">
      <xs:annotation>
        <xs:documentation>Name of the ListBox control. Used to reference the control in scripts.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onkillfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onselcancel">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onselchange">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onsetfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onvalidate">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="readonly">
      <xs:annotation>
        <xs:documentation>Specifies whether the list box's value can be modified by the user.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="required">
      <xs:annotation>
        <xs:documentation>Specifies if the user must enter some text in the list box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="showvalues" />
    <xs:attribute ref="sort">
      <xs:annotation>
        <xs:documentation>Specifies if the items in the list box are automatically sorted alphabetically.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="tabstop">
      <xs:annotation>
        <xs:documentation>Specifies if the items in the list box are automatically sorted alphabetically.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="vscroll">
      <xs:annotation>
        <xs:documentation>Specifies if the list box should have a vertical scroll bar</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

See Also

PAGE Element | ArcPad Preferences File Schema

© 2012 All Rights Reserved.